Node / meshtastic / Meshtastic-Android / files / core / navigation / src / commonMain / kotlin / org / meshtastic / core / navigation / MultiBackstack.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.navigation

Tff7b72import T7ee787androidx.compose.runtime.Composable

Tff7b72import T7ee787androidx.compose.runtime.MutableState

Tff7b72import T7ee787androidx.compose.runtime.getValue

Tff7b72import T7ee787androidx.compose.runtime.key

Tff7b72import T7ee787androidx.compose.runtime.mutableStateOf

Tff7b72import T7ee787androidx.compose.runtime.remember

Tff7b72import T7ee787androidx.compose.runtime.saveable.Saver

Tff7b72import T7ee787androidx.compose.runtime.saveable.rememberSaveable

Tff7b72import T7ee787androidx.compose.runtime.setValue

Tff7b72import T7ee787androidx.navigation3.runtime.NavBackStack

Tff7b72import T7ee787androidx.navigation3.runtime.NavKey

Tff7b72import T7ee787androidx.navigation3.runtime.rememberNavBackStack

T8b949e/** Manages independent backstacks for multiple tabs. */

Tff7b72class T56d364MultiBackstackTb4b4b4(Tff7b72val Te6edf3startTabTb4b4b4: Te6edf3NavKeyTb4b4b4, Tff7b72private Tff7b72val Te6edf3currentTabStateTb4b4b4: Te6edf3MutableStateTff7b72<Te6edf3NavKeyTff7b72>Tb4b4b4) Tb4b4b4{

Tff7b72var Te6edf3backStacksTb4b4b4: Te6edf3MapTff7b72<Te6edf3NavKeyTb4b4b4, Te6edf3NavBackStackTff7b72<Te6edf3NavKeyTff7b72>Tff7b72> Tff7b72= Te6edf3emptyMapTb4b4b4(Tb4b4b4)

Tff7b72var Te6edf3currentTabRouteTb4b4b4: Te6edf3NavKey Tff7b72by Te6edf3currentTabState

Te6edf3private Tff7b72set

Tff7b72val Te6edf3activeBackStackTb4b4b4: Te6edf3NavBackStackTff7b72<Te6edf3NavKeyTff7b72>

Tff7b72getTb4b4b4(Tb4b4b4) Tff7b72= Te6edf3backStacksTff7b72[Te6edf3currentTabRouteTff7b72] Tff7b72?: Te6edf3errorTb4b4b4(Ta5d6ff"Ta5d6ffStack for Tffd700$Te6edf3currentTabRouteTa5d6ff not foundTa5d6ff"Tb4b4b4)

T8b949e/** Switches to a new top-level tab route. */

Tff7b72fun Td2a8ffnavigateTopLevelTb4b4b4(Te6edf3routeTb4b4b4: Te6edf3NavKeyTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3rootKey Tff7b72= Te6edf3TopLevelDestinationTb4b4b4.Te6edf3fromNavKeyTb4b4b4(Te6edf3routeTb4b4b4)Tff7b72?.Te6edf3route Tff7b72?: Te6edf3route

Tff7b72if Tb4b4b4(Te6edf3currentTabRoute Tff7b72=Tff7b72= Te6edf3rootKeyTb4b4b4) Tb4b4b4{

T8b949e// Repressing the same tab resets its stack to just the root

Te6edf3activeBackStackTb4b4b4.Te6edf3replaceAllTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3rootKeyTb4b4b4)Tb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

T8b949e// Switching to a different tab

Te6edf3currentTabRoute Tff7b72= Te6edf3rootKey

Tb4b4b4}

Tb4b4b4}

T8b949e/** Handles back navigation according to the "exit through home" pattern. */

Tff7b72fun Td2a8ffgoBackTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3currentStack Tff7b72= Te6edf3activeBackStack

Tff7b72if Tb4b4b4(Te6edf3currentStackTb4b4b4.Te6edf3size Tff7b72> T79c0ff1Tb4b4b4) Tb4b4b4{

Te6edf3currentStackTb4b4b4.Te6edf3removeLastOrNullTb4b4b4(Tb4b4b4)

Tff7b72return

Tb4b4b4}

T8b949e// If we're at the root of a non-start tab, switch back to the start tab

Tff7b72if Tb4b4b4(Te6edf3currentTabRoute Tff7b72!Tff7b72= Te6edf3startTabTb4b4b4) Tb4b4b4{

Te6edf3currentTabRoute Tff7b72= Te6edf3startTab

Tb4b4b4}

Tb4b4b4}

T8b949e/**

* Applies a deep-link backstack.

*

* If the path's root is a top-level tab (Connections/Nodes/Map/Settings/Messages), switch to that tab and replace

* its stack with the full path. If the root is instead a nested route that no tab owns — e.g. `FirmwareGraph`

* (reached from both Settings and Connections) or `WifiProvision` — push the path onto the *current* tab's stack

* rather than switching [currentTabRoute] to a key that has no backstack. Doing the latter made [activeBackStack]

* throw `Stack for <route> not found` and crashed the app on those deep links (e.g.

* `meshtastic://.../firmware/update`).

*/

Tff7b72fun Td2a8ffhandleDeepLinkTb4b4b4(Te6edf3navKeysTb4b4b4: Te6edf3ListTff7b72<Te6edf3NavKeyTff7b72>Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3rootKey Tff7b72= Te6edf3navKeysTb4b4b4.Te6edf3firstOrNullTb4b4b4(Tb4b4b4) Tff7b72?: Tff7b72return

Tff7b72val Te6edf3topLevel Tff7b72= Te6edf3TopLevelDestinationTb4b4b4.Te6edf3fromNavKeyTb4b4b4(Te6edf3rootKeyTb4b4b4)Tff7b72?.Te6edf3route

Tff7b72if Tb4b4b4(Te6edf3topLevel Tff7b72!Tff7b72= Tff7b72nullTb4b4b4) Tb4b4b4{

Te6edf3currentTabRoute Tff7b72= Te6edf3topLevel

Te6edf3backStacksTff7b72[Te6edf3topLevelTff7b72]Tff7b72?.Te6edf3replaceAllTb4b4b4(Te6edf3navKeysTb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

T8b949e// Nested route not owned by a tab: push onto the current tab's stack (mirrors how in-app code

T8b949e// navigates to these via backStack.add) so the deep link opens and back returns to the app.

Te6edf3backStacksTff7b72[Te6edf3currentTabRouteTff7b72]Tff7b72?.Te6edf3addAllTb4b4b4(Te6edf3navKeysTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

T8b949e/** Saver that persists the active tab ordinal across process death. */

Tff7b72private Tff7b72val Te6edf3CurrentTabSaver Tff7b72=

Te6edf3SaverTff7b72<Te6edf3MutableStateTff7b72<Te6edf3NavKeyTff7b72>Tb4b4b4, Tffa657IntTff7b72>Tb4b4b4(

Te6edf3save Tff7b72= Tb4b4b4{ Te6edf3state Tff7b72-Tff7b72>

Te6edf3TopLevelDestinationTb4b4b4.Te6edf3entriesTb4b4b4.Te6edf3indexOfFirst Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3routeTff7b72::Tff7b72class == T56d364stateTb4b4b4.Te6edf3valueTff7b72::Tff7b72class }.T56d364takeIf Tb4b4b4{ Tffa657it Tff7b72>Tff7b72= T79c0ff0 Tb4b4b4}

Tb4b4b4}Tb4b4b4,

Te6edf3restore Tff7b72= Tb4b4b4{ Te6edf3ordinal Tff7b72-Tff7b72>

Te6edf3mutableStateOfTb4b4b4(Te6edf3TopLevelDestinationTb4b4b4.Te6edf3entriesTb4b4b4.Te6edf3getOrNullTb4b4b4(Te6edf3ordinalTb4b4b4)Tff7b72?.Te6edf3route Tff7b72?: Te6edf3TopLevelDestinationTb4b4b4.Te6edf3ConnectTb4b4b4.Te6edf3routeTb4b4b4)

Tb4b4b4}Tb4b4b4,

Tb4b4b4)

T8b949e/** Remembers a [MultiBackstack] for managing independent tab navigation histories with Navigation 3. */

Tf0883e@Composable

Tff7b72fun Td2a8ffrememberMultiBackstackTb4b4b4(Te6edf3initialTabTb4b4b4: Te6edf3NavKey Tff7b72= Te6edf3TopLevelDestinationTb4b4b4.Te6edf3ConnectTb4b4b4.Te6edf3routeTb4b4b4)Tb4b4b4: Te6edf3MultiBackstack Tb4b4b4{

Tff7b72val Te6edf3stacks Tff7b72= Te6edf3mutableMapOfTff7b72<Te6edf3NavKeyTb4b4b4, Te6edf3NavBackStackTff7b72<Te6edf3NavKeyTff7b72>Tff7b72>Tb4b4b4(Tb4b4b4)

Te6edf3TopLevelDestinationTb4b4b4.Te6edf3entriesTb4b4b4.Te6edf3forEach Tb4b4b4{ Te6edf3dest Tff7b72-Tff7b72>

Te6edf3keyTb4b4b4(Te6edf3destTb4b4b4.Te6edf3routeTb4b4b4) Tb4b4b4{ Te6edf3stacksTff7b72[Te6edf3destTb4b4b4.Te6edf3routeTff7b72] Tff7b72= Te6edf3rememberNavBackStackTb4b4b4(Te6edf3MeshtasticNavSavedStateConfigTb4b4b4, Te6edf3destTb4b4b4.Te6edf3routeTb4b4b4) Tb4b4b4}

Tb4b4b4}

Tff7b72val Te6edf3currentTabState Tff7b72=

Te6edf3rememberSaveableTb4b4b4(Te6edf3saver Tff7b72= Te6edf3CurrentTabSaverTb4b4b4) Tb4b4b4{

Te6edf3mutableStateOfTb4b4b4(Te6edf3TopLevelDestinationTb4b4b4.Te6edf3fromNavKeyTb4b4b4(Te6edf3initialTabTb4b4b4)Tff7b72?.Te6edf3route Tff7b72?: Te6edf3initialTabTb4b4b4)

Tb4b4b4}

Tff7b72val Te6edf3multiBackstack Tff7b72= Te6edf3remember Tb4b4b4{ Te6edf3MultiBackstackTb4b4b4(Te6edf3initialTabTb4b4b4, Te6edf3currentTabStateTb4b4b4) Tb4b4b4}

Te6edf3multiBackstackTb4b4b4.Te6edf3backStacks Tff7b72= Te6edf3stacks

Tff7b72return Te6edf3multiBackstack

Tb4b4b4}